Scroll to navigation

zlascl.f(3) LAPACK zlascl.f(3)

NAME

zlascl.f

SYNOPSIS

Functions/Subroutines


subroutine zlascl (TYPE, KL, KU, CFROM, CTO, M, N, A, LDA, INFO)
ZLASCL multiplies a general rectangular matrix by a real scalar defined as cto/cfrom.

Function/Subroutine Documentation

subroutine zlascl (character TYPE, integer KL, integer KU, double precision CFROM, double precision CTO, integer M, integer N, complex*16, dimension( lda, * ) A, integer LDA, integer INFO)

ZLASCL multiplies a general rectangular matrix by a real scalar defined as cto/cfrom.

Purpose:


ZLASCL multiplies the M by N complex matrix A by the real scalar
CTO/CFROM. This is done without over/underflow as long as the final
result CTO*A(I,J)/CFROM does not over/underflow. TYPE specifies that
A may be full, upper triangular, lower triangular, upper Hessenberg,
or banded.

Parameters:

TYPE


TYPE is CHARACTER*1
TYPE indices the storage type of the input matrix.
= 'G': A is a full matrix.
= 'L': A is a lower triangular matrix.
= 'U': A is an upper triangular matrix.
= 'H': A is an upper Hessenberg matrix.
= 'B': A is a symmetric band matrix with lower bandwidth KL
and upper bandwidth KU and with the only the lower
half stored.
= 'Q': A is a symmetric band matrix with lower bandwidth KL
and upper bandwidth KU and with the only the upper
half stored.
= 'Z': A is a band matrix with lower bandwidth KL and upper
bandwidth KU. See ZGBTRF for storage details.

KL


KL is INTEGER
The lower bandwidth of A. Referenced only if TYPE = 'B',
'Q' or 'Z'.

KU


KU is INTEGER
The upper bandwidth of A. Referenced only if TYPE = 'B',
'Q' or 'Z'.

CFROM


CFROM is DOUBLE PRECISION

CTO


CTO is DOUBLE PRECISION
The matrix A is multiplied by CTO/CFROM. A(I,J) is computed
without over/underflow if the final result CTO*A(I,J)/CFROM
can be represented without over/underflow. CFROM must be
nonzero.

M


M is INTEGER
The number of rows of the matrix A. M >= 0.

N


N is INTEGER
The number of columns of the matrix A. N >= 0.

A


A is COMPLEX*16 array, dimension (LDA,N)
The matrix to be multiplied by CTO/CFROM. See TYPE for the
storage type.

LDA


LDA is INTEGER
The leading dimension of the array A.
If TYPE = 'G', 'L', 'U', 'H', LDA >= max(1,M);
TYPE = 'B', LDA >= KL+1;
TYPE = 'Q', LDA >= KU+1;
TYPE = 'Z', LDA >= 2*KL+KU+1.

INFO


INFO is INTEGER
0 - successful exit
<0 - if INFO = -i, the i-th argument had an illegal value.

Author:

Univ. of Tennessee

Univ. of California Berkeley

Univ. of Colorado Denver

NAG Ltd.

Date:

June 2016

Definition at line 145 of file zlascl.f.

Author

Generated automatically by Doxygen for LAPACK from the source code.

Tue Nov 14 2017 Version 3.8.0